docs: Move documentation to inline comments: gdkapplaunchcontext

diff --git a/docs/reference/gdk/tmpl/.gitignore b/docs/reference/gdk/tmpl/.gitignore
index 9c314b99117feb1d66f313bfd59c584945c90e07..a05bd1c6999aa0d846504cfb91a740c06f56ae12 100644 (file)
--- a/docs/reference/gdk/tmpl/.gitignore
+++ b/docs/reference/gdk/tmpl/.gitignore
@@ -1,6 +1,7 @@
 cairo_interaction.sgml
 colors.sgml
 dnd.sgml
+gdkapplaunchcontext.sgml
 pixbufs.sgml
 regions.sgml
 windows.sgml

diff --git a/docs/reference/gdk/tmpl/gdkapplaunchcontext.sgml b/docs/reference/gdk/tmpl/gdkapplaunchcontext.sgml
deleted file mode 100644 (file)
index 78928a4..0000000
--- a/docs/reference/gdk/tmpl/gdkapplaunchcontext.sgml
+++ /dev/null
@@ -1,110 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-Application launching
-
-<!-- ##### SECTION Short_Description ##### -->
-Startup notification for applications
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-GdkAppLaunchContext is an implementation of #GAppLaunchContext that
-handles launching an application in a graphical context. It provides
-startup notification and allows to launch applications on a specific
-screen or workspace.
-</para>
-<example>
-<title>Launching an application</title>
-<programlisting>
-GdkAppLaunchContext *context;
-
-context = gdk_app_launch_context_new (<!-- -->);
-
-gdk_app_launch_context_set_screen (my_screen);
-gdk_app_launch_context_set_timestamp (event-&gt;time);
-
-if (!g_app_info_launch_default_for_uri ("http://www.gtk.org", context, &amp;error))
-  g_warning ("Launching failed: %s\n", error-&gt;message);
-
-g_object_unref (context);
-</programlisting>
-</example>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### TYPEDEF GdkAppLaunchContext ##### -->
-<para>
-An opaque structure representing an application launch context.
-</para>
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_new ##### -->
-<para>
-
-</para>
-
-@void: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_set_display ##### -->
-<para>
-
-</para>
-
-@context: 
-@display: 
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_set_screen ##### -->
-<para>
-
-</para>
-
-@context: 
-@screen: 
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_set_desktop ##### -->
-<para>
-
-</para>
-
-@context: 
-@desktop: 
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_set_timestamp ##### -->
-<para>
-
-</para>
-
-@context: 
-@timestamp: 
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_set_icon ##### -->
-<para>
-
-</para>
-
-@context: 
-@icon: 
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_set_icon_name ##### -->
-<para>
-
-</para>
-
-@context: 
-@icon_name: 
-
-

diff --git a/gdk/gdkapplaunchcontext.c b/gdk/gdkapplaunchcontext.c
index 46fd99a4fd9222396152cb63eccc74c1e50784da..1bd4dbbf298924672e2dbe68892d92973dab2b5f 100644 (file)
--- a/gdk/gdkapplaunchcontext.c
+++ b/gdk/gdkapplaunchcontext.c
@@ -29,6 +29,34 @@
 #include "gdkintl.h"
 
 
+/**
+ * SECTION:gdkapplaunchcontext
+ * @Short_description: Startup notification for applications
+ * @Title: Application launching
+ *
+ * GdkAppLaunchContext is an implementation of #GAppLaunchContext that
+ * handles launching an application in a graphical context. It provides
+ * startup notification and allows to launch applications on a specific
+ * screen or workspace.
+ * <example>
+ * <title>Launching an application</title>
+ * <programlisting>
+ * GdkAppLaunchContext *context;
+ *
+ * context = gdk_app_launch_context_new (<!-- -->);
+ *
+ * gdk_app_launch_context_set_screen (my_screen);
+ * gdk_app_launch_context_set_timestamp (event->time);
+ *
+ * if (!g_app_info_launch_default_for_uri ("http://www.gtk.org", context, &error))
+ *   g_warning ("Launching failed: %s\n", error->message);
+ *
+ * g_object_unref (context);
+ * </programlisting>
+ * </example>
+ */
+
+
 static void    gdk_app_launch_context_finalize    (GObject           *object);
 static gchar * gdk_app_launch_context_get_display (GAppLaunchContext *context,
                                                    GAppInfo          *info,